home *** CD-ROM | disk | FTP | other *** search
/ Power Programmierung 2 / Power-Programmierung CD 2 (Tewi)(1994).iso / tools / edit / boxer / install / readme.2nd < prev    next >
Encoding:
Text File  |  1994-01-05  |  11.2 KB  |  275 lines
  1.  
  2.         ------------------------------------------------------
  3.         This file contains answers to commonly asked questions
  4.         ------------------------------------------------------
  5.  
  6. If you have a laptop computer and have trouble with BOXER's default color
  7. settings, this may be because your video card announces itself to be color,
  8. but your screen is monochrome.  Issue the following DOS command:
  9.  
  10.                COPY MONO.CLR DEFAULT.CLR <Enter>
  11.  
  12. to set the monochrome color file to be the default.  You may later wish
  13. to use the Set Colors command to select suitable colors for your screen.
  14. Alternatively, you may use the -n option flag to force monochrome output.
  15.  
  16. ----
  17.  
  18. On computers with AT keyboards, BOXER sets the keyboard repeat rate to
  19. the fastest setting upon entry to the editor.  This contributes to the
  20. fast screen scrolling you see in BOXER.  Because the repeat rate can be
  21. set, but not read, BOXER sets the rate to normal upon exit.  If you wish
  22. for the fast rate to persist after exiting, add the -kx flag to the
  23. BOXER environment string.  If you prefer a different repeat rate,
  24. experiment with various values with the -kd and -kr options.  If you
  25. prefer that the keyboard rate not be changed at all, use the -k0 option.
  26. A full display of these and other options can be seen by doing "B -?".
  27.  
  28. ----
  29.  
  30. The default macro set supplied with BOXER includes a macro to spawn an
  31. external spell check utility to operate upon the current file.  As
  32. supplied, the macro will run with ShareSpell, if present on your system.
  33. (See REGISTER.DOC for notes about receiving an evaluation copy of
  34. ShareSpell.) The macro can be easily edited or re-recorded to run other
  35. spell checkers, or any other text-filtering utility.
  36.  
  37. The macro makes use of the DOS Shell command to name the utility to be
  38. run, and the "%1" sequence which expands to the name of the current file
  39. being edited.  Macro keys are not stored within the DOS shell, so the
  40. macro must be terminated upon return to BOXER.
  41.  
  42. This is the macro as supplied:
  43.  
  44.     <macro=S><name=spell check>
  45.     <write file><DOS command>ss<space>%1<enter><enter><enter><reload>
  46.     <start of line><enter>
  47.  
  48. This same macro technique can be used to smoothly integrate other utility
  49. programs with BOXER.
  50.  
  51. ----
  52.  
  53. Though BOXER cannot be installed directly to a 360K floppy, it is possible
  54. to create a diskette on another machine which contains the files needed for
  55. editing on a single 360K floppy drive system.  Create the "BACKUP" directory
  56. on the floppy and copy the following files to the root:
  57.  
  58.                B.EXE, BOXER.DOC, BOXER.IDX and DEFAULT.*
  59.  
  60. The BOXER executable B.EXE is in fact fully self-contained.  The additional
  61. files are needed only if you desire online help or custom- screen colors,
  62. macros, print parameters or key assignments.
  63.  
  64. ----
  65.  
  66. Upgrading from previous versions...
  67.  
  68. During installation, you were offered the chance to use existing DEFAULT
  69. files from a previous installation.  When appropriate, the files from
  70. the new release have been installed as NEWDFLT.*, leaving the old files
  71. with the name DEFAULT.*.  In this way you can decide whether to use the
  72. new default files, or your own.
  73.  
  74. If you are upgrading BOXER from a prior release and intend to use your
  75. old .KEY file(s), you will need to run RECONFIG to assign keys to the
  76. new commands added in this version.  See RECONFIG.DOC for details.
  77.  
  78. ----
  79.  
  80. Q. Why does BOXER come up with the file I was last editing?  I want
  81. to start with a new one.
  82.  
  83. When BOXER is started without naming a file on the command line it
  84. automatically loads the last files which were being edited and
  85. restores the cursor position in each file. To start editing a new
  86. file, simply name it on the command line when starting BOXER.
  87. If you would like to select from a menu of files when starting the
  88. editor, use the -0 option to indicate that a file menu should be
  89. presented upon startup.
  90.  
  91. ----
  92.  
  93. Q. Why don't ASCII characters in the range 240-249 display as expected?
  94.  
  95. A.  By default, BOXER uses ASCII characters 240-249 to represent
  96. embedded printer codes.  These appear on screen as specially colored
  97. digits to distinguish them from neighboring text.  Embedded printer
  98. codes provide a shorthand method of accessing various features of
  99. your printer without placing long sequences of printer codes
  100. directly in the text file.  See Section 18 in the help file for more
  101. information.
  102.  
  103. To configure BOXER to display these values normally, do one of the
  104. following: From within the editor, use Ctrl-F3 or the Printer Codes
  105. option in the WP menu to disable embedded printer codes.  If you
  106. prefer, the -e option can be placed in the "BOXER" environment
  107. string to make the change permanent.  The -e option can also be used
  108. on the command line, or in a batch file that calls BOXER.
  109.  
  110. ----
  111.  
  112. When using BOXER with an offline mail reader, you may wish to call the
  113. editor with the following command line:
  114.  
  115.                            B -w72 -s
  116.                            
  117. These options will turn ON wordwrap and set the text width to 72, and
  118. designate that Spaces should be inserted when the Tab key is pressed
  119. or when "virtual space" is filled by the editor.
  120.  
  121. ----
  122.  
  123. You can install BOXER as a Transfer item in the Borland IDE making it
  124. easy to jump into BOXER for source file editing.  Select the "Transfer"
  125. option in the C IDE (or the "Tools" option in the Pascal IDE) with
  126. <Alt-O><T>.  Edit an existing entry to name BOXER and its path (usu.
  127. C:\BOXER\B.EXE).  Enter the following text for the command line to
  128. invoke BOXER:
  129.  
  130.                   $SAVE CUR $MEM(640) -g$LINE $EDNAME
  131.  
  132. After selecting a Hot Key, select the New box to create a new Transfer
  133. item.  Finally, select OK to save the setup.
  134.  
  135. This IDE macro will give BOXER the needed information to place you on
  136. the same text line as in the IDE.  With this configuration, you'll be
  137. able to quickly switch to BOXER from within the IDE - return to the IDE
  138. is automatic upon exiting BOXER.
  139.  
  140. ----
  141.  
  142. Paradox users can install BOXER within their development environment so
  143. the editor can be used to easily correct program errors.  Use the Paradox
  144. configuration feature to specify the path to BOXER, and the command line
  145. option which will jump to a given line number.  For example:
  146.  
  147.                     C:\BOXER\B.EXE * -g**
  148.  
  149. Paradox will insert the filename in place of '*' and the line number in
  150. place of '**'.
  151.  
  152. ----
  153.  
  154. AutoCad users can designate BOXER as their editor of choice by making
  155. an entry in the ACAD.PGP file.  See your documentation for complete
  156. information, but an entry such as that below should be sufficient:
  157.  
  158.                       BOXER,B,640,File to Edit,4
  159.  
  160. ----
  161.  
  162. U.K. note:  The Ctrl-@ sequence is attainable on UK keyboards as Ctrl-2.
  163.  
  164. ----
  165.  
  166. Early versions of BOXER required the use of the -d option to specify
  167. the editor's home directory.  This option is no longer required for
  168. users with DOS v3.x or better, and so can be removed from the "BOXER"
  169. environment variable.  You would only need to use this option now if you
  170. decide to keep the BOXER executable in a directory other than the home
  171. directory, or if you are using DOS 2.x.  (NOTE: if used, this option
  172. must appear in the "BOXER" environment string.  It cannot be placed in
  173. the file DEFAULT.CFG, as can all other option flags.)
  174.  
  175. ----
  176.  
  177. Color Syntax Highlighting: If you find that multi-line block comments are
  178. not highlighted completely, adjust the COMSEARCH parameter in DEFAULT.CFG
  179. for the language you use.  This parameter specifies how many lines BOXER
  180. will search when attempting to locate the beginning of a multi-line
  181. comment.  Set the value based on your coding style -- excessive values can
  182. slow down screen display.
  183.  
  184. ----
  185.  
  186. DR DOS Users: there is an incompatibility between BOXER's DOS Shell and
  187. Compile commands and the EMM386 driver in DR DOS.  In order to use
  188. BOXER's swapping feature, you will need to disable access by the driver
  189. to the Upper Memory area.  DR DOS provides a utility for just this
  190. purpose.  To disable access, run the following command: MEMMAX -U
  191.  
  192. If you need access to the Upper Memory area at other times, you might
  193. prepare a batch file to disable/enable memory access as follows:
  194.  
  195.                     MEMMAX -U
  196.                     B %1 %2 %3 %4 %5 %6 %7 %8
  197.                     MEMMAX +U
  198.  
  199. ----
  200.  
  201. DESQview Tips: you may wish to configure "ticks" to 15/1 or 30/1, when
  202. not downloading, to get smoother mouse and cursor movement.  The mouse
  203. driver should be loaded before entering DESQview.
  204.  
  205. When using DESQview's Mark and Transfer function, set BOXER's auto
  206. indent option to OFF to ensure that each line in the block transferred
  207. begins in the same column.
  208.  
  209. You may experience "mouse droppings" if you use BOXER with DESQview and
  210. have an old mouse driver.  Microsoft's driver v6.14 shows this symptom,
  211. while versions 7.04 and later do not.
  212.  
  213. ----
  214.  
  215. On some computers, and in certain video modes, BOXER's text cursor has
  216. been reported to be invisible.  If this happens try using the "-8"
  217. option flag to specify that no changes should be made to the cursor
  218. size.  Also, toggling between 43/50 line mode and 25 line mode has been
  219. found to be a workaround.  The following macro, recorded as a startup
  220. macro, will automate the use of this workaround.
  221.  
  222. <macro=[><name=>
  223. <toggle video mode><right><right><enter><toggle video mode><left><left>
  224. <enter>
  225.  
  226. See BMAC.DOC for details on how to create and edit the DEFAULT.M macro
  227. file.  The invisible cursor problem is under investigation.
  228. ----
  229.  
  230. On some laptop computers, there are no keyboard equivalents for the - +
  231. and * keys found on the numeric keypads of full size keyboards.  By default,
  232. BOXER uses these keys for marked text manipulations, so you may wish to
  233. use RECONFIG to select alternate keys for these commands.
  234.  
  235. ----
  236.  
  237. The program "MACWIN" was released with a known bug which conflicts with
  238. several installation programs, including BOXER's.  As per the instructions
  239. in that program, it must be removed before BOXER can be installed.
  240.  
  241. ----
  242.  
  243. Programmers: if you would like help in making your program more friendly
  244. for blind users, contact Jeff Bishop.  Jeff is developing a set of guide-
  245. lines called the Braille and Speech Friendly Interface (BSFI).  You can
  246. write to Jeff for details: 420 E. Yavapai Road, Apt H, Tucson, AZ 85705.
  247.  
  248. ----
  249.  
  250. I heartily recommend this book to aspiring authors:
  251.  
  252.  
  253.     If you're considering launching a shareware product, you need:
  254.  
  255.                             The ShareWare Book <ASP>
  256.  
  257.                  A Whole Earth Catalog for software developers
  258.  
  259.     Tips, tools and techniques for successful shareware marketing and
  260.     development.  Includes market research, publicity, getting paid,
  261.     distribution, resources, product protection, registration encouragement,
  262.     trademarks, copyrights, licensing, channel management, business issues,
  263.     support, taxes, manuals, packaging, shipping, international trade.
  264.  
  265.                   "Everything an author needs to get started"
  266.  
  267.         Look for ShareB.EXE in CIS SHARE lib 0 or ShareBk*.zip on BBSs.
  268.  
  269.                                By Robert Schenot
  270.                              Compass / New England
  271.                                  P.O. Box 117
  272.                            Portsmouth, NH  03802-0117
  273.                                  (603) 431 8030
  274.  
  275.